home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 19 / AMIGAplus Sonderheft 19 (1999)(ICP)(DE)[!].iso / Magazin / Future-PD / SpiffV1.6 / SPIFF.dok < prev    next >
Text File  |  1998-08-21  |  11KB  |  404 lines
  1.  
  2.  
  3.                 SPIFF = Show Powergepackte IFF ILBM's
  4.  
  5.                          V1.6   ( 20.08.98 )
  6.  
  7.                 von
  8.  
  9.                             Rainer Lunge
  10.  
  11.  
  12.                          Bedienungsanleitung
  13.                          ~~~~~~~~~~~~~~~~~~~
  14.  
  15.  
  16.  
  17.     Allgemeines !
  18.     ~~~~~~~~~~~~~
  19.  
  20.  WICHTIG !!!!
  21.  Die Benutzung des Programms erfolgt auf eigene Gefahr !!!
  22.  Ich , der Programmierer , übernehme keinerlei Haftung für Schäden ,
  23.  die durch die Benutzung des Programms entstehen oder entstanden sind !!!
  24.  
  25.  Eine gewerbliche Nutzung oder Vertrieb des Programms ist
  26.  grundsätzlich untersagt , und nur mit meinem schriftlichen
  27.  Einverständnis erlaubt .
  28.  
  29.  Die Weitergabe des Programms ist nur zusammen mit dieser
  30.  Dokumentation erlaubt .
  31.  
  32.  SPIFF ist Cardware . Wer SPIFF gut findet und es benutzt möge mir bitte
  33.  eine Postkarte zusenden .
  34.  Ansonsten können die Dateien frei ohne eine Gegenleistung kopiert
  35.  werden . Dabei bleiben die Rechte im Besitz des Programmierers . Deshalb
  36.  ist es grundsätzlich untersagt Veränderungen am Programm oder an dieser
  37.  Dokumentation vorzunehmen .
  38.  
  39.  Sollten GURU's bei der Benutzung von SPIFF auftreten brauche ich eine
  40.  möglichst genaue Beschreibung wie es dazu kam . Außerdem brauche ich
  41.  Euren Absender für eventuelle Rückfragen und um Euch eine fehlerfreie
  42.  Version von SPIFF zusenden zu können .
  43.  
  44.  Verbesserungsvorschläge für SPIFF nehme ich natürlich gern entgegen .
  45.  
  46.  Meine Adresse lautet :
  47.  
  48.       Rainer Lunge
  49.       Dr.-Alexander-Str 38
  50.       19258 Boizenburg
  51.  
  52.  EMail: RLunge@t-online.de
  53.  
  54.  Die neueste Version des Programms gibt es immer zuerst auf meiner
  55.  Homepage :
  56.  
  57.      http://home.t-online.de/home/RLunge/Rainer.html
  58.  
  59.  
  60.  Das Programm wurde auf einem Amiga 600 turbo ( 68020 / 25 MHz ) mit 10 MB
  61.  Ram und Kick 3.1 entwickelt .
  62.  Geschrieben wurde das Programm in C und mit Dice V3.0 compiliert .
  63.  
  64.  
  65.  
  66.     Systemvoraussetzungen !
  67.     ~~~~~~~~~~~~~~~~~~~~~~~
  68.  
  69.  Benötigt wird ein Amiga mit Kick 2.x und mindestens 1 MB Ram .
  70.  
  71.  Für eine einwandfreie Funktion benötigt SPIFF die "iff.library" V 23
  72.  und die "powerpacker.library" V 36 im LIBS: Verzeichnis .
  73.  
  74.  
  75.     Rechtliches !
  76.     ~~~~~~~~~~~~~
  77.  
  78.  Die iff.library ist Copyright © bei Christian A. Weber .
  79.  Die powerpacker.library ist Copyright © bei Nico François .
  80.  
  81.  
  82.     Warum SPIFF ?
  83.     ~~~~~~~~~~~~~
  84.  
  85.  Mein Freund Cord suchte für seine Disketten-Briefe einen Bildanzeiger ,
  86.  der mit ein paar Effekten ausgestattet ist , um die Briefe etwas
  87.  interressanter gestalten zu können .
  88.  
  89.  Nun gibt es ja schon recht viele Bildanzeigeprogramme !
  90.  Warum also noch eines schreiben ?
  91.  Nun , die meisten Programme können mehrere verschiedene Bildformate
  92.  verarbeiten . Wenn es aber um die Darstellung auf dem Bildschirm geht ,
  93.  wird das Bild einfach nur angezeigt .
  94.  
  95.  Und genau da kommt SPIFF ins Spiel !
  96.  SPIFF versteht zwar nur das IFF ILBM Format . Aber mit SPIFF hat man die
  97.  Möglichkeit ein Bild auf 24 verschiedene Arten ein- bzw. auszublenden .
  98.  Mit SPIFF kann man auf einfachste Weise eine Diashow erzeugen .
  99.  Beim Abspielen der Diashow kann man nicht nur vorwärts , sondern auch
  100.  rückwärts durch diese "surfen" .
  101.  
  102.  Da SPIFF für den Einsatz in Disketten-Briefen gedacht ist und diese über
  103.  die Startup-Sequemce abgewickelt werden , habe ich auf einen
  104.  Workbench-Start verzichtet . SPIFF ist also nur vom Cli aus startbar .
  105.  
  106.  
  107.     Benutzung !
  108.     ~~~~~~~~~~~
  109.  
  110.  SPIFF ist nur vom Cli aus startbar , da außer des Bildnamens noch weitere
  111.  Optionen angegeben werden können .
  112.  Der Cli-Aufruf sieht so aus :
  113.  
  114.  SPIFF [-Option] Dateiname [-Option] Dateiname .....
  115.  
  116.  Wird SPIFF ohne die Angabe einer Datei bzw. mit dem "?" aufgerufen , werden
  117.  alle Optionen mit einer kurzen Erklärung ausgegeben .
  118.  
  119.  Optionen :
  120.  
  121.     -Beeaa  Bildname
  122.  
  123.     -R  Bildname
  124.  
  125.     -S  Scriptdatei
  126.  
  127.     -d  Directory
  128.  
  129.     -D  Directory
  130.  
  131.     -Deeaa Directory
  132.  
  133.     -k  [Option]  Bildname
  134.    
  135.  
  136.  Erklärung der einzelnen Optionen :
  137.  
  138.  -Beeaa Bildname -Beeaa Bildname ....
  139.  
  140.      Legt die Art und Weise fest , wie das Bild ein- und ausgeblendet
  141.      wird . Dabei steht ee für das Einblenden und aa für das
  142.      Ausblenden . Diese Variablen können Werte zwischen 00 und 24
  143.      haben . Werte größer als 24 werden ignoriert bzw. setzt SPIFF
  144.      diese auf 00 .
  145.      Die Zahlenfolge nach -B muß vierstellig sein , da sonst diese
  146.      Option nicht richtig erkannt wird .
  147.  
  148.      Bei Bildname ist der volle Pfad anzugeben .
  149.  
  150.      Beispiel :
  151.  
  152.          SPIFF -B0102 Work:Brush/XY.iff ....
  153.  
  154.      oder
  155.  
  156.          SPIFF -b0102 Work:Brush/XY.iff ....
  157.  
  158.  
  159.  
  160.  
  161.  -R Bildname -R Bildname ....
  162.  
  163.      Mit dieser Option wird die Art und Weise der Ein- und Ausblendung
  164.      des Bildes per Zufallsgenerator ausgewählt . Dabei wird das 
  165.      Blendverfahren 00 nicht berücksichtigt . Es findet also eine
  166.      Auswahl zwischen den Blendverfahren 01 bis 24 statt .
  167.  
  168.      Bei Bildname ist der volle Pfad anzugeben .
  169.  
  170.      Beispiel :
  171.  
  172.          SPIFF -R Work:Brush/XY.iff ....
  173.  
  174.      oder
  175.  
  176.          SPIFF -r Work:Brush/XY.iff ....
  177.  
  178.  
  179.  
  180.  
  181.  -S Scriptdatei
  182.  
  183.      Mit dieser Option ist es möglich eine Dia-Show ablaufen zu lassen .
  184.  
  185.      Bei Scriptdatei ist der volle Pfad anzugeben .    
  186.  
  187.      Beispiel :
  188.  
  189.          SPIFF -S Work:Text/SPIFF.bat
  190.  
  191.      oder
  192.  
  193.          SPIFF -s Work:Text/SPIFF.bat
  194.  
  195.  
  196.      In der Scriptdatei darf nur ein Bildname mit und ohne Blend- Option
  197.      pro Zeile stehen .
  198.  
  199.      Beispiel für eine Scriptdatei :
  200.  
  201.          Work:Brush/Bild_01.iff
  202.          -b0120 Work:Brush/Bild_02.iff
  203.          -r Work:Brush/Bild_03.iff
  204.          -R Work:Brush/Bild_04.iff
  205.          -B0210 Work:Brush/Bild_05.iff
  206.          Work:Brush/Bild_06.iff
  207.          ..............
  208.          ..............
  209.          ..............
  210.          ..............
  211.  
  212.  
  213.      Die Größe der Scriptdatei wird nur durch die Größe des verfügbaren
  214.      Speichers begrenzt .
  215.  
  216.  
  217.  
  218.  
  219.  -d Directory
  220.  
  221.      Mit dieser Option ist es möglich die in einem Verzeichnis
  222.      vorhandenen Bilder anzuzeigen . Dabei wird , wie bei der Option
  223.      -R , die Art und Weise der Ein- und Ausblendung des Bildes per
  224.      Zufallsgenerator ausgewählt .
  225.  
  226.      Sind im angegebenen Verzeichnis Unterverzeichnisse vorhanden ,
  227.      werden diese erkannt und übersprungen .
  228.  
  229.      Bei Directory ist der Pfad anzugeben . Es ist dabei nicht
  230.      unbedingt erforderlich den "/" am Ende des Pfades anzugeben ,
  231.      da SPIFF dieses Zeichen selbstständig anhängen kann .
  232.  
  233.      Beispiel :
  234.  
  235.          SPIFF -d Work:Brush/
  236.  
  237.      oder
  238.  
  239.          SPIFF -d Work:Brush
  240.  
  241.  
  242.  
  243.  
  244.  -D Directory
  245.  
  246.      Mit dieser Option ist es möglich , wie bei der Option  -d  , die
  247.      in einem Verzeichnis vorhandenen Bilder anzuzeigen . Die Bilder
  248.      werden dabei nur mit dem Blendverfahren 00 ein- und ausgeblendet .
  249.  
  250.      Sind im angegebenen Verzeichnis Unterverzeichnisse vorhanden ,
  251.      werden diese erkannt und übersprungen .
  252.  
  253.      Bei Directory ist der Pfad anzugeben . Es ist dabei nicht
  254.      unbedingt erforderlich den "/" am Ende des Pfades anzugeben ,
  255.      da SPIFF dieses Zeichen selbstständig anhängen kann .
  256.  
  257.      Beispiel :
  258.  
  259.          SPIFF -D Work:Brush/
  260.  
  261.      oder
  262.  
  263.          SPIFF -D Work:Brush
  264.  
  265.  
  266.  
  267.   -Deeaa Directory
  268.  
  269.       Mit dieser Option ist es möglich , wie bei der Option  -D  , die
  270.       in einem Verzeichnis vorhandenen Bilder anzuzeigen . 
  271.      Mit dieser Option kann man aber festlegen , mit welchem Blend-
  272.       verfahren die Bilder ein- und ausgeblendet werden sollen .
  273.      Dabei steht ee für das Einblenden und aa für das
  274.       Ausblenden . Diese Variablen können Werte zwischen 00 und 24
  275.       haben . Werte größer als 24 werden ignoriert bzw. setzt SPIFF
  276.       diese auf 00 .
  277.       Die Zahlenfolge nach -D muß vierstellig sein , da sonst diese
  278.       Option nicht richtig erkannt wird .
  279.  
  280.       Sind im angegebenen Verzeichnis Unterverzeichnisse vorhanden ,
  281.       werden diese erkannt und übersprungen .
  282.  
  283.       Bei Directory ist der Pfad anzugeben . Es ist dabei nicht
  284.       unbedingt erforderlich den "/" am Ende des Pfades anzugeben ,
  285.       da SPIFF dieses Zeichen selbstständig anhängen kann .
  286.  
  287.       Beispiel :
  288.  
  289.           SPIFF -D0304 Work:Brush/
  290.  
  291.       oder
  292.  
  293.           SPIFF -D0304 Work:Brush
  294.  
  295.  
  296.   
  297.   -k [Option] Bildname
  298.  
  299.       Mit dieser Option wird die Maus- bzw Tastaturabfrage
  300.      abgeschaltet .
  301.       Durch diese Option ist es möglich SPIFF mittels der
  302.      Startup-Sequence oder einer anderen Batch-Datei komplett zu
  303.      steuern .
  304.       Hier ein Beispiel für eine Batch-Datei :
  305.  
  306.       Run SPIFF -k -d Work:Pic/    ->startet SPIFF mit der -k
  307.                       Option 
  308.       SetENV PROCNR 0        ->erzeugt eine ENV-Variable
  309.       Status COM SPIFF > ENV:PROCNR  ->schreibt die Prozeßnummer
  310.                       von SPIFF ( durch Run hat
  311.                       SPIFF einen eigenen Prozeß )
  312.                        in die ENV-Variable
  313.       Break $PROCNR            ->sendet das Break-Signal an
  314.                       den Prozeß , dessen Nummer
  315.                       in PROCNR gespeichert ist
  316.  
  317.       SPIFF wird nicht grundsätzlich durch das Break-Signal beendet .
  318.       Vielmehr wird das nächste anzuzeigende Bild angezeigt . Ist
  319.      das angezeigte Bild das letzte anzuzeigende bzw. einzigste
  320.      Bild wird SPIFF dadurch beendet .
  321.  
  322.       Diese Option kann mit jeder anderen Option kombiniert werden .
  323.  
  324.  
  325.  
  326.  Ab Version 1.4 können alle Optionen miteinander kombiniert und
  327.  mehrmals angegeben werden .
  328.  Es dürfen aber in einer Scriptdatei die Optionen -S , -d , -D und
  329.  -Deeaa nicht angegeben werden ! Sollte jemand dies doch tun , erkennt
  330.  dies das Programm und gibt eine entsprechende Fehlermeldung aus .
  331.  
  332.  
  333.  
  334.  Bedient wird SPIFF mit der Maus .
  335.  Durch die Betätigung der rechten Maustaste wird das nächste Bild angezeigt .
  336.  Ist das angezeigte Bild das einzigste oder das letzte anzuzeigende Bild
  337.  wird SPIFF dadurch beendet .
  338.  Durch die Betätigung der linken Maustaste wird das vorherige Bild
  339.  angezeigt . Ist das angezeigte Bild das erste anzuzeigende Bild blinkt
  340.  der Bildschirm dadurch kurz auf .
  341.  Durch die Betätigung der ESC-Taste wird SPIFF beendet .
  342.  
  343.  HINWEIS : Wird SPIFF mit der -k Option aufgerufen ist die Maus- bzw.
  344.        Tastaturabfrage abgeschaltet . SPIFF reagiert dann nur noch
  345.        auf das Break-Signal ( siehe Erklärung zur -k Option )
  346.  
  347.  Meldungen über fehlerhafte Dateien oder nicht ausreichenden Speicher werden
  348.  im Cli ausgegeben oder können als Requester erscheinen . Das hängt von der
  349.  Art des Fehlers ab .
  350.  
  351.  
  352.  
  353.     Zur Zeit unterstützte Bildformate
  354.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  355.  
  356.  
  357.     Format                ECS        AGA
  358.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  359.     HiRes bis 16 Farben        ja        ja
  360.     SuperHiRes            ja        ja
  361.     LoRes bis 32 Farben        ja        ja
  362.     128 Farben            konvertiert    ja
  363.     256 Farben            konvertiert    ja
  364.     EHB                ja        ja
  365.     HAM 6                ja        ja
  366.     HAM 8                konvertiert    ja
  367.     24 Bit                konvertiert    konvertiert
  368.  
  369.  IFF ILBM Bilder mit 128 und 256 Farben werden auf ECS-Rechnern nach
  370.  LoRes 32 Farben konvertiert . Dabei sind aber alle Blendarten nutzbar .
  371.  HAM 8 Bilder werden auf ECS-Rechner nach HAM 6 konvertiert .
  372.  Diese Bilder werden grundsätzlich mit der Blendart 00 ein- bzw
  373.  ausgeblendet .
  374.  IFF ILBM Bilder mit 24 Bitplanes werden z.Z. nur nach HAM6
  375.  konvertiert . Für AGA Rechner wird es aber noch eine Konvertierung
  376.  nach HAM8 geben .
  377.  Diese Bilder werden , wie bei HAM 8 Bildern , grundsätzlich mit der Blendart 00
  378.  ein- bzw. ausgeblendet , egal welche Option dabei angegeben wurde .
  379.  
  380.   
  381.  
  382.  
  383.  
  384.  
  385.        Entwicklungsgeschichte
  386.      ~~~~~~~~~~~~~~~~~~~~~~
  387.  
  388.  V1.3    - erste Veröffentlichung
  389.  
  390.  V1.4    - autoscrollenden Screen eingebaut
  391.      - Blendroutinen überarbeitet , so das auch Bilder mit ungeraden
  392.        Auflösungen vollständig angezeigt werden
  393.      - Option -Deeaa eingebaut
  394.      - Fehler bei der Kombination der Optionen -S , -d und -D 
  395.        beseitigt
  396.  
  397.  V1.5    - 24bit IFF ILBM werden nach HAM6 konvertiert und angezeigt
  398.      - 4 neue Blendarten eingebaut
  399.      - die Option -k eingebaut
  400.  
  401.  V1.6    - interne Umstruckturierung des Programms
  402.      - Konvertierung und Anzeige von HAM 8 , 128 und 256 farbigen
  403.       Bildern auf ECS-Rechnern
  404.